<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>运行时配置</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="filesystem.installation.html">« 安装</a></li>
      <li style="float: right;"><a href="filesystem.resources.html">资源类型 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="filesystem.setup.html">安装/配置</a></li>
    <li>运行时配置</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="filesystem.configuration" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>文件系统和流配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="filesystem.configuration.html#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.allow-url-include" class="link">allow_url_include</a></td>
      <td>&quot;0&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自 PHP 7.4.0 起废弃。</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.user-agent" class="link">user_agent</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.default-socket-timeout" class="link">default_socket_timeout</a></td>
      <td>&quot;60&quot;</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
    </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.from" class="link">from</a></td>
      <td>&quot;&quot;</td>
      <td>PHP_INI_ALL</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a></td>
      <td>&quot;0&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>自 PHP 8.1.0 起弃用。</td>
     </tr>

     <tr>
      <td><a href="filesystem.configuration.html#ini.sys-temp-dir" class="link">sys_temp_dir</a></td>
      <td>&quot;&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td class="empty">&nbsp;</td>
     </tr>

    </tbody>
   
  </table>

 </p>

 <p class="para">这是配置指令的简短说明。</p>

 <p class="para">
  <dl>
   
    <dt id="ini.allow-url-fopen">
     <code class="parameter">allow_url_fopen</code>
     <span class="type">bool</span>
    </dt>

    <dd>

     <p class="para">
      本选项激活了 URL 形式的 fopen 封装协议使得可以访问 URL
      对象例如文件。默认的封装协议提供用 ftp 和 http 协议来访问<a href="features.remote-files.html" class="link">远程文件</a>，一些扩展库例如
      <a href="ref.zlib.html" class="link">zlib</a> 可能会注册更多的封装协议。
     </p>
    </dd>

   

   
    <dt id="ini.allow-url-include">
     <code class="parameter">allow_url_include</code>
     <span class="type">bool</span>
    </dt>

    <dd>

     <p class="para">
      This option allows the use of URL-aware fopen wrappers with the following 
      functions: <span class="function"><a href="function.include.html" class="function">include</a></span>, <span class="function"><a href="function.include-once.html" class="function">include_once</a></span>, 
      <span class="function"><a href="function.require.html" class="function">require</a></span>, <span class="function"><a href="function.require-once.html" class="function">require_once</a></span>.
     </p>
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       这个设置项需要开启 allow_url_fopen 。
      </p>
     </p></blockquote>
    </dd>

   

   
    <dt id="ini.user-agent">
     <code class="parameter">user_agent</code>
     <span class="type">string</span>
    </dt>

    <dd>

     <p class="para">
      定义 PHP 发送的 User-Agent。
     </p>
    </dd>

   

   
    <dt id="ini.default-socket-timeout">
     <code class="parameter">default_socket_timeout</code>
     <span class="type">int</span>
    </dt>

    <dd>

     <p class="para">
      指定基于 socket 的流的默认超时时间（秒）。指定一个负值意味着不会超时。
     </p>
    </dd>

   

   
    <dt id="ini.from">
     <code class="parameter">from</code>
     <span class="type">string</span>
    </dt>

    <dd>

     <p class="para">
      这个 email 地址在使用 ftp 封装器的时候用于未认证的 FTP
      连接，在使用 http 封装器的时候用于 HTTP 连接的消息头中的
      From 字段。
     </p>
    </dd>

   

   
    <dt id="ini.auto-detect-line-endings">
     <code class="parameter">auto_detect_line_endings</code>
     <span class="type">bool</span>
    </dt>

    <dd>

     <p class="para">
      当设为 On 时，PHP 将检查通过
      <span class="function"><a href="function.fgets.html" class="function">fgets()</a></span> 和 <span class="function"><a href="function.file.html" class="function">file()</a></span>
      取得的数据中的行结束符号是符合 Unix，MS-DOS，还是 Macintosh 的习惯。
     </p>
     <p class="para">
      这使得 PHP 可以和 Macintosh 系统交互操作，但是默认值是
      Off，因为在检测第一行的
      EOL 习惯时会有很小的性能损失，而且在 Unix
      系统下使用回车符号作为项目分隔符的人们会遭遇向下不兼容的行为。
     </p>
    </dd>

   

   
    <dt id="ini.sys-temp-dir">
     <code class="parameter">sys_temp_dir</code>
     <span class="type">string</span>
    </dt>

    <dd>

     <p class="para">
     </p>
    </dd>

   

  </dl>

 </p>
</div></div></div></body></html>